Skip to main content

SmartAgent Version 10.1.1

Release Date: June 23, 2026

Version Overview​

SmartAgent 10.1.1 is a 10.1.x feature enhancement release. Since Version 10.1.0 was not released separately, its changes have been merged into 10.1.1. This release adds SmartAgent capabilities such as ESM application monitoring, watchdog status protection, and system time jump detection, while integrating upgrades including JavaAgent 9.14.0, NodejsAgent 8.0.0, and NginxAgent 3.10.0. All language agents now support HTTP response header injection control via switch.

  • ✨ ESM application monitoring: agentloader supports automatic monitoring of ECMAScript Module (ESM) applications; NodejsAgent 8.0.0 adds ESM monitoring support

  • ✨ SmartAgent enhancements: watchdog periodically checks agent.status and restores abnormal values; automatic exit and restart when system time jumps exceed 30s; Serverless agent package adds built-in CA root certificates

  • ✨ Multi-agent upgrades: JavaAgent 9.14.0, DotnetAgent 6.16.1, PHPAgent 8.7.0, PythonAgent 8.7.4, NginxAgent 3.10.0, ApacheAgent 3.5.0, SDKAgent 5.16.0

  • 🔧 General optimizations: Improved cgroup v2 metric collection, uvicorn process group identification, non-root installation permissions, and installation command compatibility

  • 🔧 Version 10.1.1 fix: Fixed Node.js application startup failure when NODE_OPTIONS is non-empty (affects: 10.1.0)

Upgrade Recommendation
  • Users running ESM modules or Node.js 14.18+ with async-intensive workloads should upgrade for ESM monitoring and AsyncLocalStorage async tracing optimizations;
  • Environments on 10.1.0 affected by NODE_OPTIONS causing Node.js startup failures should upgrade to 10.1.1 as soon as possible;
  • Scenarios requiring HTTP response header injection control, sampling mode / intelligent intensity overlay threshold mode, or container cgroup v2 metrics should prioritize upgrading.

Linux x86_64 System​

Supported Platform Versions​

  • One Platform: V2.2.2 and above

Integrated Agent Versions​

  • JavaAgent: 9.14.0
  • DotnetAgent: 6.16.1
  • PHPAgent: 8.7.0
  • PythonAgent: 8.7.4
  • NodejsAgent: 8.0.0
  • NginxAgent: 3.10.0
  • ApacheAgent: 3.5.0
  • SDKAgent: 5.16.0
  • GoAgent: 5.0.3
  • logsAgent: 3.0.1

New Features​

  1. Watchdog status protection: Periodically checks agent.status changes and restores abnormal values (checks every 2 seconds; automatically restores to on and prints one alert when the value is not on).
  2. agentloader ESM application monitoring: Supports automatic monitoring of ECMAScript Module (ESM) applications.
  3. Serverless agent package adds certs directory: Built-in CA root certificates (CA Bundle).
  4. System time change detection: Automatically exits and restarts when time jump exceeds 30s threshold.

Feature Optimizations and Fixes​

1. JavaAgent Upgraded to 9.14.0​

New Features

  • weblogic-12.2.1.4.0 database connection pool adaptation;
  • log4j2 log dyeing supports jackson layouts;
  • Supports switch to control HTTP response header injection;
  • Trace collection mode overlays slow/error call collection based on configuration.

2. DotnetAgent Upgraded to 6.16.1​

New Features

  • Supports switch to control HTTP response header injection;
  • Supports sampling mode / intelligent intensity overlay threshold mode.

3. PHPAgent Upgraded to 8.7.0​

New Features

  • Supports switch to control HTTP response header injection.

Bug Fixes

  • Fixed potential crash caused by ZTS multi-threading (e.g., apache event/worker + libphp.so) (affects: PHPAgent versions before 8.7.0, SmartAgent versions before 10.1.0).

4. PythonAgent Upgraded to 8.7.4​

New Features

  • Supports switch to control HTTP response header injection;
  • Adapted for Xiaorui usage scenarios.

5. NodejsAgent Upgraded to 8.0.0​

New Features

  • Added monitoring support for ECMAScript Module (ESM) applications (requires SmartAgent 10.1.0+ agent);
  • Added adaptation for mongoose 8.23.0, 5.13.22, amqplib 0.10.0, 0.10.9, ioredis 5.8.2, Elasticsearch 16.7.1, and Express 4.19.2;
  • Added Span code file information and supplemented component identifiers for some trace nodes;
  • Added support for node v24.14.1, v14.21.3;
  • Supports switch to control HTTP response header injection.

Feature Optimizations

  • Optimized async context tracing mechanism: For Node.js 14.18 and above with AsyncLocalStorage.enterWith capability, Agent defaults to using AsyncLocalStorage for transaction context propagation, reducing performance overhead of traditional async_hooks Map tracing in Promise, async/await, timer, and other async-intensive scenarios.
  • Recommendation: If the monitored application heavily uses Promise, async/await, or high-frequency async tasks, upgrading Node.js to 14.18 or above is recommended for better async tracing performance.

Bug Fixes

  • Fixed trace correlation anomalies in some async scenarios, ensuring correct Span parent-child relationships (affects: NodejsAgent versions before 8.0.0, SmartAgent versions before 10.1.0).

6. NginxAgent Upgraded to 3.10.0​

New Features

  • Supports switch to control HTTP response header injection;
  • nginx and openresty new version adaptation:
    • nginx: 1.28.1～1.28.3; 1.29.4～1.29.8; 1.30.0～1.30.2; 1.31.0～1.31.1
    • openresty: 1.29.2.*

7. ApacheAgent Upgraded to 3.5.0​

New Features

  • Supports switch to control HTTP response header injection.

Bug Fixes

  • Fixed HTML page rendering anomalies caused by truncated JS injection script tags (affects: ApacheAgent versions before 3.5.0, SmartAgent versions before 10.1.0).

8. SDKAgent Upgraded to 5.16.0​

New Features

  • Allows dotnet to support HTTP response header injection control via switch;
  • Supports sampling mode intelligent intensity overlay threshold mode;
  • Improved elasticsearch backend detail field.

9. SmartAgent Self Optimizations and Fixes​

Feature Optimizations

  • Optimized uvicorn process group identification: When uvicorn module entry file cannot be located, module attribute uses the original value directly;
  • Removed errors caused by modifying /home directory permissions during non-root installation;
  • Optimized scenario where SmartAgent installation fails when installation command contains numbers matching the installation process pid;
  • Optimized cgroup v2 metric collection: Reads cgroup v2 memory.max as memory hard limit, cleans up residual quota when cpu.max is max, and accumulates cgroup v1/v2 multi-device blkio data to avoid inaccurate container memory, CPU quota, and block IO metrics reporting.

Bug Fixes — The following is specific to Version 10.1.1; all other items above are from Version 10.1.0

  • Fixed Node.js application startup failure when NODE_OPTIONS is non-empty (affects: SmartAgent 10.1.0).

Linux ARM64 System​

Supported Platform Versions​

  • One Platform: V2.2.2 and above

Integrated Agent Versions​

  • JavaAgent: 9.14.0
  • DotnetAgent: 6.16.1
  • PHPAgent: 8.7.0
  • PythonAgent: 8.7.4
  • NginxAgent: 3.10.0
  • SDKAgent: 5.16.0
  • GoAgent: 5.0.3
  • logsAgent: 3.0.1

New Features​

  1. Watchdog status protection (same as Linux x86_64).
  2. agentloader ESM application monitoring (same as Linux x86_64).
  3. Serverless agent package adds certs directory (same as Linux x86_64).
  4. System time change detection (same as Linux x86_64).

Feature Optimizations and Fixes​

Platform Notes

Updates for this platform are largely the same as Linux x86_64, with differences in supported agents:

Feature Optimizations and Fixes

  • Same as Linux x86_64 (including JavaAgent 9.14.0, DotnetAgent 6.16.1, PHPAgent 8.7.0, PythonAgent 8.7.4, NginxAgent 3.10.0, SDKAgent 5.16.0 upgrades and SmartAgent self optimizations)

Notes

  • ARM64 does not currently support NodejsAgent or ApacheAgent

Windows x86_64 Platform​

Supported Platform Versions​

  • One Platform: V2.2.2 and above

Integrated Agent Versions​

  • JavaAgent: 9.14.0
  • DotnetAgent: 6.16.1
  • logsAgent: 3.0.1

New Features​

  1. Watchdog status protection: Periodically checks agent.status changes and restores abnormal values (checks every 2 seconds; automatically restores to on and prints one alert when the value is not on).
  2. Serverless agent package adds certs directory: Built-in CA root certificates (CA Bundle).
  3. System time change detection: Automatically exits and restarts when time jump exceeds 30s threshold.

Feature Optimizations and Fixes​

1. JavaAgent Upgraded to 9.14.0​

New Features

  • weblogic-12.2.1.4.0 database connection pool adaptation;
  • log4j2 log dyeing supports jackson layouts;
  • Supports switch to control HTTP response header injection;
  • Trace collection mode overlays slow/error call collection based on configuration.

2. DotnetAgent Upgraded to 6.16.1​

New Features

  • Supports switch to control HTTP response header injection;
  • Supports sampling mode / intelligent intensity overlay threshold mode.

3. SmartAgent Self Optimizations​

Feature Optimizations

  • Optimized uvicorn process group identification: When uvicorn module entry file cannot be located, module attribute uses the original value directly.

Compatibility Notes​

Platform Compatibility​

Operating SystemSupported ArchitectureMinimum One Version
Linuxx86_64V2.2.2
LinuxARM64V2.2.2
Windowsx86_64V2.2.2